Composition functionality for 2D nodes. More...

#include <kanzi/core.ui/node/node_compositor2d.hpp>

Classes
struct	CompositionState
	CompositionState defines the state held by the compositor while Kanzi performs the composition, that is, between calls to beginComposition and blitComposition. More...

struct	GeometryState
	GeometryState defines the state used for rendering a quad. More...

Public Types
enum	CompositingBits { CompositingBitUserTarget, CompositingBitBlend, CompositingBitCache, CompositingBitForce, CompositingBitOffscreen, CompositingBitBlendAndChildren, CompositingBitOpacityAndChildren, CompositingBitPerspective, CompositingBitRequest, CompositingBitEffect, CompositingBitCount }
	Enum for compositing bit flags. More...

enum	PotentialCompositingBits { PotentialCompositingBitCache, PotentialCompositingBitViewport, PotentialCompositingBitCount }
	Enum for compositing potential bit flags. More...

Public Member Functions
bool	beginComposition (Renderer3D &renderer, CompositionStack &compositionStack, CompositionManager *compositionManager, const CompositionContentRequirements &requirements, bool drawFlagSet)
	Begins the composition. More...

void	blitComposition (Domain domain, Renderer3D &renderer, CompositionStack &compositionStack, CompositionManager compositionManager, QuadDescription &backgroundQuad, const Matrix3x3 &transform, Vector2 quadSize, const Matrix4x4 perspectiveMatrix, const Matrix4x4 projectionMatrix)
	Blits the composition. More...

void	disableCaching ()
	Disable caching. More...

void	enableCaching (CachingMode mode)
	Enable caching. More...

void	endComposition (Renderer3D &renderer, CompositionStack &compositionStack, CompositionManager *compositionManager)
	End final composition. More...

const Geometry &	getBlitGeometry () const
	Gets the blit geometry. More...

Matrix3x3	getBlitLocalTransformation () const
	Gets the blit geometry local transformation. More...

CachingMode	getCachingMode () const
	Gets the caching mode stored in the compositor. More...

const Geometry &	getClearGeometry () const
	Gets the clear geometry. More...

Matrix3x3	getClearLocalTransformation () const
	Gets the local transformation of the blit geometry. More...

BrushRenderer *	getCompositionBrushRenderer () const
	Access composition brush renderer. More...

TextureSharedPtr	getCompositionTarget () const
	Access managed composition target. More...

NodeEffect2D *	getEffect () const
	Gets the active effect or null pointer. More...

NodeEffectRenderer2D *	getEffectRenderer () const
	Gets the active effect renderer or null pointer if compositor has no active effect. More...

TextureSharedPtr	getManagedCompositionTarget () const
	Gets the managed composition target. More...

Vector2	getUserCompositionTargetSize () const
	Gets the size of user composition target. More...

bool	hasCompositionBrushRenderer () const
	Indicates whether a composition brush renderer has been created. More...

bool	hasManagedCompositionTarget () const
	Indicates whether a managed composition target has been allocated. More...

bool	hasUserCompositionTarget () const
	Indicates whether user composition target is set. More...

void	invalidateCompositionBrush ()
	Invalidate composition brush. More...

bool	isBlendCompositionRequested () const
	Indicates whether composition due to blending is requested. More...

bool	isBlendModeAndChildrenCompositionRequest () const
	Indicates whether composition due to blend mode and children is requested. More...

bool	isCacheValid () const
	Indicates whether or not the cache is valid. More...

bool	isCompositionPotentiallyRequired () const
	Indicates whether composition can potentially be required during rendering. More...

bool	isCompositionRequested () const
	Indicates whether composition is requested from code. More...

bool	isCompositionRequired () const
	Indicates whether compositing the node is required. More...

bool	isCompositionRequiredDuringRendering (const optional< Matrix3x3 > &transform, bool drawFlagSet) const
	Indicates whether compositing the node is required during rendering. More...

bool	isForceComposition () const
	Indicates whether force composition flag is set. More...

bool	isOffscreenRendering () const
	Indicates whether offscreen rendering is enabled. More...

bool	isOpacityAndChildrenCompositionRequest () const
	Indicates whether composition due to opacity is requested. More...

bool	isPerspectiveCompositionRequested () const
	Indicates whether composition due to perspective transform is requested. More...

bool	isPotentialCompositionBitViewport () const
	Indicates whether potential composition request flag is set. More...

void	onDetached ()
	Kanzi calls this function when the node that owns the compositor becomes detached. More...

void	renderCompositionQuad (Domain *domain, Renderer &renderer, BrushRenderer &brushRenderer, const Texture &texture, QuadDescription &backgroundQuad, const Matrix4x4 &transform, Vector2 quadSize)
	Render composition quad. More...

void	resetBlitGeometry ()
	Resets the blit geometry. More...

void	resetClearGeometry ()
	Resets the clear geometry. More...

void	resizeUserCompositionTarget (Vector2 compositionSize)
	Resize automatic sizes in user composition target if necessary. More...

void	restoreResources (Vector2 compositionSize)
	Restore resources. More...

void	setBlendCompositionRequested (bool enabled)
	Sets the blend composition request flag. More...

void	setBlendModeAndChildrenCompositionRequested (bool enabled)
	Sets the opacity composition request flag. More...

void	setBlitGeometry (Domain *domain, Renderer &renderer, const QuadDescription &quad)
	Sets the blit geometry for the compositor. More...

void	setCacheValid (bool valid)
	Set cache validity flag. More...

void	setClearGeometry (Domain *domain, Renderer &renderer, const QuadDescription &quad)
	Sets the clear geometry for the compositor. More...

void	setCompositionRequested (bool enabled)
	Sets the compositing request. More...

void	setEffect (NodeEffect2D *effect)
	Sets the active effect or clears the active effect with empty shared pointer. More...

void	setForceComposition (bool enabled)
	Sets force composition. More...

void	setOffscreenRendering (bool enabled)
	Sets the offscreen rendering flag. More...

void	setOpacityAndChildrenCompositionRequested (bool enabled)
	Sets the opacity composition request flag. More...

void	setPerspectiveCompositionRequested (bool enabled)
	Sets the perspective composition request flag. More...

void	setPotentialCompositionBitVierport (bool enabled)
	Sets the potential composition request flag. More...

void	setUserCompositionBrush (BrushSharedPtr brush)
	Sets user composition brush. More...

void	setUserCompositionTarget (TextureSharedPtr texture)
	Set user composition target. More...

void	updateRender (Node2D &node, const CompositionContentRequirements &requirements, optional< int > blendMode, float opacity, bool translucencyHint)
	Update for rendering, recreating composition targets and brush renderers as needed. More...

	~NodeCompositor2D ()
	Destructor. More...

Static Public Member Functions
static unique_ptr< NodeCompositor2D >	create ()
	Creates a NodeCompositor2D. More...

Protected Member Functions
TextureSharedPtr	beginFinalComposition (CompositionStack &compositionStack, CompositionManager *compositionManager, const CompositionContentRequirements &requirements, bool needsRender)
	Begins the final composition. More...

void	blitFinalComposition (Domain domain, Renderer3D &renderer, CompositionStack &compositionStack, CompositionManager compositionManager, TextureSharedPtr renderTargetTexture, QuadDescription &backgroundQuad, const Matrix3x3 &transform, Vector2 quadSize, const Matrix4x4 perspectiveMatrix, const Matrix4x4 projectionMatrix)
	Blits the final composition. More...

void	endFinalComposition (CompositionStack &compositionStack)
	Ends the final composition. More...

bool	isRenderRequired (bool drawFlagSet) const
	Indicates whether node rendering is required. More...

	NodeCompositor2D ()
	Default constructor. More...

bool	updatePersistentCompositionTarget (Node2D &node, TextureSharedPtr &managedCompositionTarget, const CompositionContentRequirements &requirements)
	Update the managed composition target to match current requirements. More...

Protected Attributes
optional< int >	m_blendMode
	Saved blend mode. More...

GeometryState	m_blitGeometryState
	Geometry state for blits. More...

bool	m_brushRenderersDirty
	Brush renderer dirty flag. More...

bool	m_cacheValid
	Cache status flag. More...

CachingMode	m_cachingMode
	Caching mode setting. More...

GeometryState	m_clearGeometryState
	Geometry state for clears. More...

bitset< CompositingBitCount >	m_compositingMask
	Bit mask for states affecting whether or not the node should compose itself and its children. More...

BrushRendererPtr	m_compositionBrushRenderer
	Composition brush renderer. More...

NodeEffectRenderer2DUniquePtr	m_effectRenderer
	Effect renderer instance, or null if no effect is active. More...

bool	m_effectRequiresCompositionBlit
	Whether the effect blit needs to be followed with composition blit. More...

CompositionBrushSharedPtr	m_managedCompositionBrush
	Composition brush managed by node. More...

TextureSharedPtr	m_managedCompositionTarget
	Current framebuffer. More...

bitset< PotentialCompositingBitCount >	m_potentialCompositingMask
	Bit mask for states affecting whether or not the node should potentially compose itself and its children. More...

optional< CompositionState >	m_state
	Active composition state, or nullopt if the composition is not active. More...

bool	m_translucencyHint
	Saved tTranslucency hint. More...

BrushSharedPtr	m_userCompositionBrush
	User-set composition brush. More...

TextureSharedPtr	m_userCompositionTarget
	User-set composition target. More...

Detailed Description

Composition functionality for 2D nodes.

Member Enumeration Documentation

enum kanzi::NodeCompositor2D::CompositingBits

Enum for compositing bit flags.

Enumerator
CompositingBitUserTarget	User composition target explicitly set.
CompositingBitBlend	Composition due to blend mode being set. Since Kanzi 3.9.1
CompositingBitCache	Caching mode is set to enabled.
CompositingBitForce	Force composition from property.
CompositingBitOffscreen	Offscreen rendering.
CompositingBitBlendAndChildren	Composition due to blending and children. Since Kanzi 3.9.1
CompositingBitOpacityAndChildren	Composition due to opacity and children.
CompositingBitPerspective	Composition due to perspective transform and children.
CompositingBitRequest	Custom request from code.
CompositingBitEffect	Composition due to applied post-processing effect.
CompositingBitCount	Number of options.

enum kanzi::NodeCompositor2D::PotentialCompositingBits

Enum for compositing potential bit flags.

Enumerator
PotentialCompositingBitCache	Caching mode is set to automatic.
PotentialCompositingBitViewport	Potential non-aligned viewport.
PotentialCompositingBitCount	Number of options.

Constructor & Destructor Documentation

kanzi::NodeCompositor2D::~NodeCompositor2D ( )

Destructor.

kanzi::NodeCompositor2D::NodeCompositor2D ( )

explicitprotected

Default constructor.

Member Function Documentation

static unique_ptr<NodeCompositor2D> kanzi::NodeCompositor2D::create ( )

static

Creates a NodeCompositor2D.

Returns: NodeCompositor2D unique pointer.

bool kanzi::NodeCompositor2D::beginComposition	(	Renderer3D &	renderer,
		CompositionStack &	compositionStack,
		CompositionManager *	compositionManager,
		const CompositionContentRequirements &	requirements,
		bool	drawFlagSet
	)

Begins the composition.

Parameters

renderer	Renderer to use.
compositionStack	Composition stack to use.
compositionManager	Composition manager to use.
requirements	Requirements for the composition target.
drawFlagSet	Whether the draw flag is set for the node or any of its descendants.

Returns: Whether to perform the rendering.

Since: Kanzi 3.9.7 consolidated composition requirements to requirements parameter.

void kanzi::NodeCompositor2D::endComposition	(	Renderer3D &	renderer,
		CompositionStack &	compositionStack,
		CompositionManager *	compositionManager
	)

End final composition.

Parameters

renderer	Renderer to use.
compositionStack	Composition stack to use.
compositionManager	Composition manager to use.

void kanzi::NodeCompositor2D::blitComposition	(	Domain *	domain,
		Renderer3D &	renderer,
		CompositionStack &	compositionStack,
		CompositionManager *	compositionManager,
		QuadDescription &	backgroundQuad,
		const Matrix3x3 &	transform,
		Vector2	quadSize,
		const Matrix4x4 *	perspectiveMatrix,
		const Matrix4x4 *	projectionMatrix
	)

Blits the composition.

Parameters

domain	Domain to use.
renderer	Renderer to use.
compositionStack	Composition stack to use.
compositionManager	Composition manager to use.
backgroundQuad	Clip quad for background area.
transform	Transform used for rendering.
quadSize	Rendered quad size.
perspectiveMatrix	Optional transform to use for perspective projection.
projectionMatrix	Optional projection to use for perspective projection.

void kanzi::NodeCompositor2D::renderCompositionQuad	(	Domain *	domain,
		Renderer &	renderer,
		BrushRenderer &	brushRenderer,
		const Texture &	texture,
		QuadDescription &	backgroundQuad,
		const Matrix4x4 &	transform,
		Vector2	quadSize
	)

Render composition quad.

Parameters

domain	Domain to use.
renderer	Renderer to use.
brushRenderer	Brush renderer to use.
texture	Texture used.
backgroundQuad	Clip quad for background area.
transform	Transform used for rendering.
quadSize	Rendered quad size.

TextureSharedPtr kanzi::NodeCompositor2D::getCompositionTarget ( ) const

Access managed composition target.

Returns: User composition target if set, otherwise the managed composition target or nullptr.

void kanzi::NodeCompositor2D::resizeUserCompositionTarget ( Vector2 compositionSize )

Resize automatic sizes in user composition target if necessary.

Parameters

compositionSize Composition size to resize to.

void kanzi::NodeCompositor2D::onDetached ( )

Kanzi calls this function when the node that owns the compositor becomes detached.

void kanzi::NodeCompositor2D::restoreResources ( Vector2 compositionSize )

Restore resources.

Will restore all GL resources and resize render targets with automatic size.

Parameters

compositionSize Composition size to resize to.

Since: Kanzi 3.9.5 removed renderer parameter.

void kanzi::NodeCompositor2D::updateRender	(	Node2D &	node,
		const CompositionContentRequirements &	requirements,
		optional< int >	blendMode,
		float	opacity,
		bool	translucencyHint
	)

Update for rendering, recreating composition targets and brush renderers as needed.

Parameters

node	The node to which to attach.
blendMode	Optional blend mode to select for the composition brush.
requirements	Requirements for the composition target.
opacity	Opacity value that should be used for rendering.
translucencyHint	Whether to use translucent rendering.

Since: Kanzi 3.9.1 blendMode parameter added.; Kanzi 3.9.6 removed opaquenessHint parameter.; Kanzi 3.9.7 consolidated composition requirements to requirements parameter.

BrushRenderer* kanzi::NodeCompositor2D::getCompositionBrushRenderer ( ) const

inline

Access composition brush renderer.

bool kanzi::NodeCompositor2D::hasCompositionBrushRenderer ( ) const

inline

Indicates whether a composition brush renderer has been created.

Returns: If a composition brush renderer exists, true, otherwise false.

void kanzi::NodeCompositor2D::setUserCompositionBrush ( BrushSharedPtr brush )

inline

Sets user composition brush.

Parameters

brush Brush to use as the composition brush.

Vector2 kanzi::NodeCompositor2D::getUserCompositionTargetSize ( ) const

Gets the size of user composition target.

Returns: Size of composition target or zero vector.

bool kanzi::NodeCompositor2D::hasUserCompositionTarget ( ) const

inline

Indicates whether user composition target is set.

Returns: If user composition target has been set true, otherwise false.

void kanzi::NodeCompositor2D::setUserCompositionTarget ( TextureSharedPtr texture )

inline

Set user composition target.

void kanzi::NodeCompositor2D::invalidateCompositionBrush ( )

inline

Invalidate composition brush.

CachingMode kanzi::NodeCompositor2D::getCachingMode ( ) const

inline

Gets the caching mode stored in the compositor.

Returns: Caching mode.

void kanzi::NodeCompositor2D::enableCaching ( CachingMode mode )

inline

Enable caching.

Parameters

mode	New caching mode, must not be CachingModeDisabled.

void kanzi::NodeCompositor2D::disableCaching ( )

inline

Disable caching.

bool kanzi::NodeCompositor2D::isCacheValid ( ) const

inline

Indicates whether or not the cache is valid.

Returns: True if yes, false if no.

void kanzi::NodeCompositor2D::setCacheValid ( bool valid )

inline

Set cache validity flag.

Parameters

valid Cache status flag.

bool kanzi::NodeCompositor2D::isCompositionRequired ( ) const

inline

Indicates whether compositing the node is required.

This query does not take draw flags into account.

Returns: If composition is required true, otherwise false.

bool kanzi::NodeCompositor2D::isCompositionPotentiallyRequired ( ) const

inline

Indicates whether composition can potentially be required during rendering.

This status is in addition to the obligatory requirement.

Returns: If composition may be required during rendering, true, otherwise false.

bool kanzi::NodeCompositor2D::isCompositionRequiredDuringRendering	(	const optional< Matrix3x3 > &	transform,
		bool	drawFlagSet
	)		const

Indicates whether compositing the node is required during rendering.

This status is in addition to the obligatory requirement.

Parameters

transform	Local override transform for the node.
drawFlagSet	Whether the draw flag is set for the node or any of its descendants.

Returns: If composition is required during rendering true, otherwise false.

bool kanzi::NodeCompositor2D::isCompositionRequested ( ) const

inline

Indicates whether composition is requested from code.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setCompositionRequested ( bool enabled )

inline

Sets the compositing request.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isForceComposition ( ) const

inline

Indicates whether force composition flag is set.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setForceComposition ( bool enabled )

inline

Sets force composition.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isOffscreenRendering ( ) const

inline

Indicates whether offscreen rendering is enabled.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setOffscreenRendering ( bool enabled )

inline

Sets the offscreen rendering flag.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isBlendCompositionRequested ( ) const

inline

Indicates whether composition due to blending is requested.

Returns: If flag is set true, otherwise false.

Since: Kanzi 3.9.1

void kanzi::NodeCompositor2D::setBlendCompositionRequested ( bool enabled )

inline

Sets the blend composition request flag.

Parameters

enabled New flag state.

Since: Kanzi 3.9.1

bool kanzi::NodeCompositor2D::isBlendModeAndChildrenCompositionRequest ( ) const

inline

Indicates whether composition due to blend mode and children is requested.

Returns: If the flag is set true, otherwise false.

Since: Kanzi 3.9.1

void kanzi::NodeCompositor2D::setBlendModeAndChildrenCompositionRequested ( bool enabled )

inline

Sets the opacity composition request flag.

Parameters

enabled New flag state.

Since: Kanzi 3.9.1

bool kanzi::NodeCompositor2D::isOpacityAndChildrenCompositionRequest ( ) const

inline

Indicates whether composition due to opacity is requested.

Returns: If the flag is set true, otherwise false.

Since: Kanzi 3.9.1

void kanzi::NodeCompositor2D::setOpacityAndChildrenCompositionRequested ( bool enabled )

inline

Sets the opacity composition request flag.

Parameters

enabled New flag state.

Since: Kanzi 3.9.1

bool kanzi::NodeCompositor2D::isPerspectiveCompositionRequested ( ) const

inline

Indicates whether composition due to perspective transform is requested.

Returns: If the flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setPerspectiveCompositionRequested ( bool enabled )

inline

Sets the perspective composition request flag.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isPotentialCompositionBitViewport ( ) const

inline

Indicates whether potential composition request flag is set.

Returns: If the flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setPotentialCompositionBitVierport ( bool enabled )

inline

Sets the potential composition request flag.

Parameters

enabled New flag state.

TextureSharedPtr kanzi::NodeCompositor2D::getManagedCompositionTarget ( ) const

inline

Gets the managed composition target.

Returns: Current composition target.

bool kanzi::NodeCompositor2D::hasManagedCompositionTarget ( ) const

inline

Indicates whether a managed composition target has been allocated.

Returns: If the managed composition target exists true, otherwise false.

void kanzi::NodeCompositor2D::setEffect ( NodeEffect2D * effect )

Sets the active effect or clears the active effect with empty shared pointer.

Since: Kanzi 3.9.0

Parameters

effect Effect instance or empty shared pointer.

NodeEffect2D* kanzi::NodeCompositor2D::getEffect ( ) const

Gets the active effect or null pointer.

Returns: Effect instance or nullptr.

Since: Kanzi 3.9.0

NodeEffectRenderer2D* kanzi::NodeCompositor2D::getEffectRenderer ( ) const

inline

Gets the active effect renderer or null pointer if compositor has no active effect.

Returns: NodeEffectRender2D instance or null pointer.

Since: Kanzi 3.9.0

const Geometry& kanzi::NodeCompositor2D::getClearGeometry ( ) const

inline

Gets the clear geometry.

Returns: Reference to clear geometry

Since: Kanzi 3.9.4

void kanzi::NodeCompositor2D::resetClearGeometry ( )

Resets the clear geometry.

Since: Kanzi 3.9.4

void kanzi::NodeCompositor2D::setClearGeometry	(	Domain *	domain,
		Renderer &	renderer,
		const QuadDescription &	quad
	)

Sets the clear geometry for the compositor.

Parameters

domain	Domain to use.
renderer	Renderer to use.
quad	Quad description.

Since: Kanzi 3.9.4

Matrix3x3 kanzi::NodeCompositor2D::getClearLocalTransformation ( ) const

Gets the local transformation of the blit geometry.

Returns: Transformation that maps the geometry to the local space of the node.

Since: Kanzi 3.9.5

const Geometry& kanzi::NodeCompositor2D::getBlitGeometry ( ) const

inline

Gets the blit geometry.

Returns: Reference to clear geometry

Since: Kanzi 3.9.4

void kanzi::NodeCompositor2D::resetBlitGeometry ( )

Resets the blit geometry.

Since: Kanzi 3.9.4

void kanzi::NodeCompositor2D::setBlitGeometry	(	Domain *	domain,
		Renderer &	renderer,
		const QuadDescription &	quad
	)

Sets the blit geometry for the compositor.

Parameters

domain	Domain to use.
renderer	Renderer to use.
quad	Quad description.

Since: Kanzi 3.9.4

Matrix3x3 kanzi::NodeCompositor2D::getBlitLocalTransformation ( ) const

Gets the blit geometry local transformation.

Returns: The local transformation mapping the geometry to node local space.

Since: Kanzi 3.9.5

bool kanzi::NodeCompositor2D::updatePersistentCompositionTarget	(	Node2D &	node,
		TextureSharedPtr &	managedCompositionTarget,
		const CompositionContentRequirements &	requirements
	)

protected

Update the managed composition target to match current requirements.

If the composition target does not exist or the settings required from it have changed, it is (re)created.

Parameters

node	Node to attach to.
managedCompositionTarget	Existing composition target.
requirements	Requirements for the composition target.

Returns: True if composition target was updated, false if not.

Since: In Kanzi 3.9.7, consolidated composition requirements to requirements parameter.

TextureSharedPtr kanzi::NodeCompositor2D::beginFinalComposition	(	CompositionStack &	compositionStack,
		CompositionManager *	compositionManager,
		const CompositionContentRequirements &	requirements,
		bool	needsRender
	)

protected

Begins the final composition.

Parameters

compositionStack	Composition stack to use.
compositionManager	Composition manager to use.
requirements	Requirements for the composition target.
needsRender	Whether to perform node rendering.

Returns: Render target to use.

Since: Kanzi 3.9.0.; Kanzi 3.9.7 consolidated composition requirements to requirements parameter.

void kanzi::NodeCompositor2D::endFinalComposition ( CompositionStack & compositionStack )

protected

Ends the final composition.

Parameters

compositionStack Composition stack to use.

void kanzi::NodeCompositor2D::blitFinalComposition	(	Domain *	domain,
		Renderer3D &	renderer,
		CompositionStack &	compositionStack,
		CompositionManager *	compositionManager,
		TextureSharedPtr	renderTargetTexture,
		QuadDescription &	backgroundQuad,
		const Matrix3x3 &	transform,
		Vector2	quadSize,
		const Matrix4x4 *	perspectiveMatrix,
		const Matrix4x4 *	projectionMatrix
	)

protected

Blits the final composition.

Parameters

domain	Domain to use.
renderer	Renderer to use.
compositionStack	Composition stack to use.
compositionManager	Composition manager to use.
renderTargetTexture	Render target texture used.
backgroundQuad	Clip quad for background area.
transform	Transform used for rendering.
quadSize	Rendered quad size.
perspectiveMatrix	Optional transform to use for perspective projection.
projectionMatrix	Optional projection to use for perspective projection.

bool kanzi::NodeCompositor2D::isRenderRequired ( bool drawFlagSet ) const

protected

Indicates whether node rendering is required.

Returns: Whether to perform node rendering.

Since: Kanzi 3.9.0

Member Data Documentation

TextureSharedPtr kanzi::NodeCompositor2D::m_managedCompositionTarget

protected

Current framebuffer.

CachingMode kanzi::NodeCompositor2D::m_cachingMode

protected

Caching mode setting.

bool kanzi::NodeCompositor2D::m_cacheValid

protected

Cache status flag.

BrushSharedPtr kanzi::NodeCompositor2D::m_userCompositionBrush

protected

User-set composition brush.

TextureSharedPtr kanzi::NodeCompositor2D::m_userCompositionTarget

protected

User-set composition target.

CompositionBrushSharedPtr kanzi::NodeCompositor2D::m_managedCompositionBrush

protected

Composition brush managed by node.

BrushRendererPtr kanzi::NodeCompositor2D::m_compositionBrushRenderer

protected

Composition brush renderer.

GeometryState kanzi::NodeCompositor2D::m_blitGeometryState

protected

Geometry state for blits.

Since: Kanzi 3.9.5

GeometryState kanzi::NodeCompositor2D::m_clearGeometryState

protected

Geometry state for clears.

Since: Kanzi 3.9.5

optional<int> kanzi::NodeCompositor2D::m_blendMode

protected

Saved blend mode.

Since: Kanzi 3.9.1

bool kanzi::NodeCompositor2D::m_translucencyHint

protected

Saved tTranslucency hint.

bool kanzi::NodeCompositor2D::m_brushRenderersDirty

protected

Brush renderer dirty flag.

bitset<CompositingBitCount> kanzi::NodeCompositor2D::m_compositingMask

protected

Bit mask for states affecting whether or not the node should compose itself and its children.

bitset<PotentialCompositingBitCount> kanzi::NodeCompositor2D::m_potentialCompositingMask

protected

Bit mask for states affecting whether or not the node should potentially compose itself and its children.

optional<CompositionState> kanzi::NodeCompositor2D::m_state

protected

Active composition state, or nullopt if the composition is not active.

NodeEffectRenderer2DUniquePtr kanzi::NodeCompositor2D::m_effectRenderer

protected

Effect renderer instance, or null if no effect is active.

bool kanzi::NodeCompositor2D::m_effectRequiresCompositionBlit

protected

Whether the effect blit needs to be followed with composition blit.

The documentation for this class was generated from the following file:

kanzi/core.ui/node/node_compositor2d.hpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation